Skip to content

chore: v0.1.5 release (PyPI debut + CHANGELOG + PRE-PYPI strip)#29

Merged
ayhammouda merged 1 commit into
mainfrom
feat/pypi-v015
May 14, 2026
Merged

chore: v0.1.5 release (PyPI debut + CHANGELOG + PRE-PYPI strip)#29
ayhammouda merged 1 commit into
mainfrom
feat/pypi-v015

Conversation

@ayhammouda
Copy link
Copy Markdown
Owner

@ayhammouda ayhammouda commented May 14, 2026 •
edited by coderabbitai Bot
Loading

Summary

PR #3 of the v0.1.5 launch wave. Three changes that go together:

  1. Version bump 0.1.4 → 0.1.5 across the three lockstep files release.yml enforces:
    • pyproject.toml:7 (project version)
    • server.json:11 (top-level version)
    • server.json:17 (packages[0].version for MCP Registry)
    • plus uv.lock (the matching lockfile bump)
  2. CHANGELOG.md created with the v0.1.5 entry following Keep-a-Changelog format. Documents the PyPI debut, the positioning anchor, the phase-9/10/11 backlog, and the dropped rename decision.
  3. README.md PRE-PYPI strip: 11 <!-- PRE-PYPI --> fenced regions removed (18 GitHub-source install URL references). README now leads with the canonical uvx python-docs-mcp-server install path everywhere.

Verified locally

  • ✅ uv build produces python_docs_mcp_server-0.1.5-py3-none-any.whl + .tar.gz
  • ✅ synonyms.yaml present in wheel (release.yml check passes)
  • ✅ Clean-venv install: python-docs-mcp-server --version reports 0.1.5
  • ✅ pytest -q — 269/269 tests passing
  • ✅ Zero PRE-PYPI markers remain in README; zero uvx --from git+ or pipx install git+ references

What lands after this PR merges

Tagging v0.1.5 will trigger .github/workflows/release.yml:

  1. build — verifies version triple lockstep, runs lint/type/test, builds wheel + sdist
  2. publish — Trusted Publishing to PyPI (https://pypi.org/project/python-docs-mcp-server/) with Sigstore attestations
  3. publish-mcp-registry — mcp-publisher updates the MCP Registry entry
  4. github-release — creates the v0.1.5 GitHub Release with artifacts

The PyPI Trusted Publisher is already configured (Repository: python-docs-mcp-server, Workflow: release.yml, Environment: pypi) — confirmed by v0.1.4 having successfully published with attestations.

Test plan

  • CI green (ci.yml, security.yml, codeql.yml)
  • grep '^version' pyproject.toml returns version = "0.1.5"
  • jq .version server.json and jq '.packages[0].version' server.json both return "0.1.5"
  • CHANGELOG.md renders cleanly on GitHub
  • After merge: git tag v0.1.5 && git push origin v0.1.5 → release.yml runs all 4 jobs green → uvx python-docs-mcp-server --version returns 0.1.5 from a clean shell

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation

    • Added CHANGELOG to document release history and track version updates
    • Simplified installation instructions with clearer, more concise setup steps
    • Streamlined configuration examples for popular MCP clients including Claude Desktop, Cursor, and Codex
    • Improved diagnostics and troubleshooting sections with updated guidance
    • Cleaned up outdated setup information throughout documentation

  • Chores

    • Version bumped to 0.1.5

Review Change Stack

@ayhammouda
chore(release): bump to v0.1.5, add CHANGELOG, strip PRE-PYPI fences
d9fa5f7 
First PyPI publish for python-docs-mcp-server. Removes the temporary
uvx --from git+ install paths and lets users install with the canonical
uvx python-docs-mcp-server / pipx install python-docs-mcp-server flows.

Locked version state across the three release.yml lockstep files:

- pyproject.toml line 7: version = "0.1.5"
- server.json line 11: top-level "version": "0.1.5"
- server.json line 17: packages[0].version "0.1.5"

CHANGELOG.md follows Keep-a-Changelog format. The v0.1.5 entry documents
the PyPI debut + the positioning anchor + the .planning/phases/0X
backlog scaffolds + the dropped rename decision.

11 <!-- PRE-PYPI --> fenced regions removed from README.md (18 GitHub
source-install URL references). README now leads with the post-PyPI
install path everywhere.

Verified locally:
- uv build produces 0.1.5 wheel + sdist
- synonyms.yaml present in wheel
- python-docs-mcp-server --version reports 0.1.5 from a clean venv
- pytest 269/269 passing
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 14, 2026 •
edited
Loading

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 8807f0fc-58be-445a-9e2c-0476145a4f01

📥 Commits

Reviewing files that changed from the base of the PR and between 020a253 and d9fa5f7.

⛔ Files ignored due to path filters (1)
  • uv.lock is excluded by !**/*.lock
📒 Files selected for processing (4)
  • CHANGELOG.md
  • README.md
  • pyproject.toml
  • server.json
📝 Walkthrough

Walkthrough

This PR releases version 0.1.5 by bumping version identifiers across configuration files, introducing release notes documenting the PyPI debut and specification additions, and simplifying README installation and configuration guidance by removing pre-PyPI GitHub-source instructions.

Changes

Version 0.1.5 Release

Layer / File(s) Summary
Version bump in configuration files
pyproject.toml, server.json		 Package version incremented from 0.1.4 to 0.1.5 in both build configuration and package registry metadata.
Release notes and changelog
CHANGELOG.md		 New changelog documents 0.1.5 additions (PyPI debut, .planning/phases/ specs), changes (README/config realignment), removals (pre-PyPI fenced regions), and preservation of 0.1.4 historical context.
README post-PyPI instruction consolidation
README.md		 Install, first-run build-index, client configuration (Claude Desktop, Cursor, Codex), diagnostics, and troubleshooting sections simplified by removing pre-PyPI GitHub-source variants and lead-ins, keeping only post-PyPI uvx-based workflows.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

  • ayhammouda/python-docs-mcp-server#26: Overlaps in README pre-PyPI and configuration sections; PR #26 renames repository URLs while this PR removes those pre-PyPI blocks entirely.

Poem

🐰 A version hop, from four to five,
PyPI dawn makes docs alive!
Pre-build ghosts swept away so clean,
Now uvx commands take the scene.
Release notes penned, the changelog shines—
thump-thump celebrates these aligned designs! ✨

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/pypi-v015

Comment @coderabbitai help to get the list of available commands and usage tips.

@ayhammouda ayhammouda merged commit 276a387 into main May 14, 2026
6 of 7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@ayhammouda